home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d8
/
zcomd506.arc
/
ZCOMMDOC.AG
< prev
next >
Wrap
Text File
|
1991-05-06
|
77KB
|
1,771 lines
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 181
ALT-N The NUKE key exits from the term function with a message and
cancels any scripts or functions that may have been executing.
ALT-1 Prompts for a DOS command, then executes that command as a
subroutine.
EXAMPLE: ALT-1 whereis *.lst
ALT-2 Prompts for a ZCOMM command, then executes that command. A
particularly useful command is "create file" which creates a capture
file without having to return to the main command prompt. Care
should be exercised not to force excessive recursion by issuing a
command (such as t or f) which would invoke the term function
recursively.
EXAMPLE: ALT-2 create capture.fil
EXAMPLE: ALT-2 display vt100
ALT-E Resets the elapsed time indication to zero.
ALT-F Full Duplex resets local echo of keyboarded characters.
ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local
echo), and 2 (local echo CR as CR LF). SEE ALSO: h numeric
parameter
ALT-I Three way toggle of i and I (Image) mode. When toggling to I
(super image) mode, ZCOMM's display emulation is set to dumb to
disable all escape sequences, most importantly those that do strange
things when used in the wrong context. When toggling out of I mode,
dumb terminal emulation is turned off.
ALT-J Toggles j (Jabberwrite) mode (q.v.).*
ALT-K Displays the contents of the soft keys.
ALT-L Ctrl-PrtSc Toggles the line printer on flag. If the printer is
being turned on, printing commences with the next character received
from the remote.
ALT-M Toggles keyboard mapping.
SEE ALSO: display mapkb command
ALT-O Toggles the Overstrike display mode, and restores the normal CRT
attribute.
(C) 1990 Omen Tech Inc Chapter 22 Term Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 182
ALT-P Toggles the parity the term function uses between 8 bits no
parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd
parity, 7 bits marking parity (8th bit set), and 7 bits spacing
parity (8 bit reset).
ALT-V Four way toggles v mode between normal, show control characters
as ^C, denote characters with parity bit (in addition to the above)
set by prepending a tilde (~), and display all characters in hex.*
22.3 Control Characters
The following characters are recognized by the term function when they
are received from the remote.
ENQ, DLE If c or C (Compuserve) mode and v mode is not in effect,
engage the Compuserve B+ Protocol. This protocol is used with the
FILTRN program and the SIG/ACCESS DOW and UPL commands. See
Compuserve's CP-MIG user group documentation for more information.
Iff enabled, these codes are acted upon when drained from the
interrupt input buffer and are not passed to the circular buffer.
The following received characters are recognized by the term function,
regardless of parity, when they are fetched from the circular buffer
for the display.
Modem Error Detected modem errors (parity error, framing error, break,
overrun) are counted in the e numeric parameter. The E numeric
parameter may be used to represent modem errors as specific,
searchable characters.
A detected overrun is displayed as a large fuzzy rectangle (hex B2).
ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host
Operation) these control characters will terminate the message.
ENQ Iff q (TWX) mode or VT100 emulation ("display vt") is in effect,
transmit the answerback string parameter to the remote. This is
equivalent to HEREIS on a Teletype(TM) machine.
BELL Generates a tone in the speaker unless visual bell display is
enabled ("display bell=visual"). If the display has fallen behind
the incoming data, ZCOMM suppresses the bell due to the relatively
long time required to perform a bell ring. If a file is being
transmitted with the term function, a bell character will pause
transmission for a short time. (Some computers send bell characters
to indicate their input buffers are becoming overloaded.)
FF If c mode is enabled, erase the screen.
XOFF Suspends file transmission from ZCOMM. XOFF is excluded from
pattern searches and does not display unless v mode is set. After a
(C) 1990 Omen Tech Inc Chapter 22 Term Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 183
timeout determined by the Kermit s numeric parameter (default 60
seconds), transmission will resume even if no XON character is
received.[3]
XON Resumes file transmission from ZCOMM. XON is excluded from
pattern searches and does not display unless v mode is set.
NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
in i (image) or v mode. They are excluded from pattern searches.
22.4 Buffer Writing
If e (Emacs) mode is set, a buffer dump is performed before each
keyboarded character is sent to the remote, since normal XOFF based
flow control is assumed to be disabled.
When the free space in the circular buffer is nearly exhausted, ZCOMM
sends an XOFF character to the remote[4] and writes the buffer
contents to the receive file[5] (if any). The circular buffer is also
written to the receive file as a result of a "w" command, ALT-W key,
or once per second if j mode is in effect.
When the circular buffer is written to a receive file, several control
characters are treated specially if i (image) mode is not set. Iff s
mode is set, all control characters, except for those listed below,
are excluded from the received file.
NULL ACK BELL XON XOFF RUBOUT ESC These characters are excluded from
the file. Most "escape sequences" are also filtered form the
cpature file. NULL, DELETE, XON, and XOFF are excluded from pattern
searches.
ETX, EOT These characters close the file if q mode is in effect, as
when ZCOMM is receiving a message in host state using TWX protocol.
Ctrl-Z (CPMEOF) Iff z mode is enabled, close the file. Otherwise this
character is discarded.
LF Iff n (nlmode) mode is on, a CR is written to the file before the
LF. Linefeed is always passed to the file.
__________
3. There is no timeout if the parameter is 0.
4. Assuming e mode is not in effect.
5. An XON is sent to the remote after this automatic buffer write
operation.
(C) 1990 Omen Tech Inc Chapter 22 Term Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 184
CR Iff a mode is in effect, a CR LF sequence is written to the file.
Otherwise, if s mode is on, CR is only written to the file as a
response to an LF in the circular buffer.
BS Backspace is written to the file unless s mode is in effect, in
which case it, and the last character written in the disk file, are
deleted by backspacing the file write pointer. This simulates the
function of backspace on common CRT terminals.
NOTE: This backspacing of the file write pointer operates the same
as Teco and Emacs editors; it does not stop at the beginning of the
line. Backspacing over tab characters is tricky because it may take
several backspaces to eliminate the spaces corresponding to one tab
character, but only one is needed to eliminate the tab character in
the output file.
HT, FF These characters are always passed to the file, even if s mode
is in effect. If ss mode is in effect, FF is not passed to the
file.
22.5 Real Time Status Line
A real time status line is displayed when DOS and OS/2 ZCOMM are in
the term function. The left part of this status line is also
displayed when ZCOMM is in Host Operation awaiting a call.
The first character position shows a blinking W if the circular buffer
is being written to disk. Otherwise, the first character position
shows an L if the keyboard has been locked by a kbdlock command, or C
if the Caps Lock key is activated.
The second position shows an X if hardware handshaking is enabled and
Clear to Send (CTS) is not received from the modem, or if an XOFF
character has been received (software handshake). This also happens
when a file upload is using the p mode with GOchar = 17 (17 is decimal
for XON) and ZCOMM has stopped at the end of a line. Otherwise, an M
is shown to indicate Keypad Mapped operation for terminal emulation.
Otherwise, an N appears if the Num Lock key is activated and the K
numeric parameter is 0 (84 key keyboard).
SEE ALSO: handshake command, Terminal Emulation, Chapter 29.
The third position displays the real time status of the following five
conditions. If more than one of the conditions is active at once, the
displayed character will represent the condition listed first.
X if the buffer has nearly filled up and ZCOMM has sent an XOFF to
suspend data transmission from the remote.
E when ZCOMM has sent an XOFF to suspend data transmission for Error
Containment(TM).
(C) 1990 Omen Tech Inc Chapter 22 Term Function Status Line
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 185
S if the term function is searching for one or more strings (defined
by the pattern command).
W if term is waiting for a character echo before resuming
transmission.
w if term is waiting for a fixed time before sending the next
character or returning from a putw or wait command.
The display column and row numbers are displayed next with the home
position equivalent to 1, 1. DOS's idea of the time of day is next.
The minutes of elapsed time follow the time of day, modulo 24 hours
(1440 minutes). The elapsed time is reset by the ALT-E function key,
restime command, and telephone number autodial.
If carrier detect is absent, an L( Local) appears after the elapsed
time. The X.PC version will display c, p, or L in this position
depending on whether ZCOMM is in character state, packet state, or
Local (no carrier detect).
The number of free characters in the Circular Buffer appears next.
A user programmed message may be displayed in right side of the status
line with the statliner string parameter. Otherwise, the right side
of the status line shows the communications port,[6] transmission
speed ("baud rate") and the parity.
The next field represents the modes that are enabled. If the b, n, p,
r, or w mode is set, that letter shows. If p mode is set with with
GOchar equal to XON (decimal 17), a P is shown.
The v mode causes the view indicator to show ^ if control characters
are being displayed in the style ^C where C is the alphabetic
character corresponding to the control character. The indicator shows
~ if characters with the 8th bit set are being displayed with a
leading ~.
Setting the a, c, e, h, i, j, l, q, s, t, u, x, and z modes causes the
corresponding letter to be displayed. The c, h, and s modes are
displayed in upper case if their value is greater than 1.
ON HOOK is displayed if the computer has disabled DTR (Data Terminal
Ready). The speed command should be used to assert DTR and allow the
modem to go off hook (connect to line), e.g., "speed 1200".
__________
6. Virtual channel number for X.PC
(C) 1990 Omen Tech Inc Chapter 22 Term Function Status Line
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 186
If a transmit file is open, a < followed by the transmit file name is
shown.
If the file upload has been stopped by a grab command, Stopped(grab)
is diplayed.
If a receive capture file is open, a > followed by the file name is
shown.
EXAMPLE: LX 01 24 23:57 ET 0:46 L 31424 1:1200 8n p^t <upload.fil
The keyboard has been "locked" by a kbdlock 1 command. File upload
has been stopped by an XOFF character. The cursor in in column 1,
line 24. The elapsed time is 46 seconds. Carrier is not present (L).
There are 31424 free bytes in the circular buffer. Transmission speed
is 1200 bits per second. Transmitted word length is 8 bits no parity
(8n). Since a speed of 1200 selects 1 stop bit, the mode is the same
as "8-N-1" mentioned by many bulletin board systems. The p mode makes
file upload pause at the end of each line for a prompt character.
View mode is set (ena -v). Finally, t mode slows the transmission of
each character from a soft keys or file. The disk file upload.fil is
being uploaded.
The s numeric parameter sets the status line display attribute. The
default of 7 provides normal video. With some displays, you can set
it to dim with a ps8 command so it won't distract you. It may be
disabled with an "ESC x 1" sequence.
SEE ALSO: statliner string parameter
22.5.1 X Windows status line When operating under some versions of
the X Windows xterm program, Unix flavors display a status line
indicating Carrier Detect, elapsed time, and buffer free size.
22.6 Conference Command/Local Editing
When the conference command is given, two cursors appear. The usual
cursor will follow text as it arrives from the remote computer. A
block cursor in the conference window follows the text you enter.
While entering text to the conference window, the standard ZCOMM
editing keys described in Chapter 18 may be used to correct
keyboarding mistakes.
When you keyboard ENTER, LF, or ESC, or when you fill up the
conference window, ZCOMM queues the line for transmission. The
conference window cursor disappears while the line is queued for
transmission.
The line is transmitted as soon as the previous line (if any) has been
sent. When transmission begins, the conference window is cleared and
the conference cursor reappears, allowing the next line to be
(C) 1990 Omen Tech Inc Chapter 22 Conference Command
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 187
keyboarded. Attempts to keyboard characters into the conference
window before transmission begins will ring the bell and be discarded.
When in the conference command, the function keys operate the same way
as they normally do in the term function. The review subcommands (F2,
PgUp, etc.) may be used to review portions of the conversation that
have scrolled off the main screen. The exit command F1 causes any
characters entered in the conference window to be discarded.
The following characters are passed directly to the remote and are not
entered into the conference window: ETX SI DLE XON XOFF DC2 DC4 (^C ^O
^P ^Q ^S ^R ^T).
Transmission from the conference window is controlled by the t, p, and
w modes and their associated parameters. If none of these modes are
set, the line is transmitted at full speed. If Half Duplex mode h is
set, ZCOMM echoes the line as it is transmitted. If H is set, a
linefeed is transmitted and displayed after the carriage return.
(C) 1990 Omen Tech Inc Chapter 22 Review Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 188
23. REVIEW FUNCTION
Review function commands page, search, cut, paste, and otherwise
manipulate captured data stored in the circular buffer.
The review function displays the approximate location of the displayed
text within the circular buffer as a percentage of the buffer contents
on the status line. Unless i mode is in effect, escape characters are
printed as $ (dollar sign) so they will not interfere with scrolling.
Review subcommands consist of a single character preceded by an
optional numeric argument. (The default value is 1.) The numeric
digits and the command are not echoed as they are entered. For
example, keyboarding 69+ moves down 69 lines.
You don't have to wait for the screen to fill before entering the next
review subcommand. This comes in handy with the n subcommand. Since
the N subcommand searches in the reverse direction, you can thumb
through messages (by searching for the subject header) very quickly,
knowing that you can back up if you went past something interesting.
23.1 Review Subcommands
Defined soft keys are executed from review iff they do not conflict
with the permanent definitions.
Ctrl-L, Ctrl-Home Ctrl-L (form feed) clears the screen and refreshes
the display without moving it. Ctrl-L is useful after an error
printout within review, or after a subcommand that writes to the
screen such as ALT-D or ALT-S.
a Toggles the autowarp display mode, then refreshes the display.
If the autowrap display mode is enabled, long lines can be
viewed, but will cause lines at the top of the screen to scroll
off.
G Go to the Nth line and display from there. If N is omitted, go
to the end instead.
Home Display starting at the beginning of the capture buffer.
r, R If a file is open as a result of a read command, read some more
of the file into the buffer, replacing about 3/4 of the previous
buffer contents (all if R subcommand). A successful r subcommand
erases the pointers set by the t and b subcommands. The data
read in from the file may overwrite the data currently displayed
on the screen. In this case, ZCOMM displays data starting with
the oldest.
(C) 1990 Omen Tech Inc Chapter 23 Review Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 189
F2, PgUp, ^B, * Display the Nth previous page (one line overlap is
provided).
SP, PgDn, ^F Clear screen and display the next Nth page.
s, / Accept a search string, terminated by RETURN. This string may
have character escapes. Search through the buffer for the Nth
instance of string. Lower case characters in string match either
case; upper case characters in string match upper case characters
only. The display starts with that line. If the search is
unsuccessful, ring bell. The search begins at the top of the
display.
SEE ALSO: ?, n, N subcommands
? Prompts for search string as above, then searches backwards for
the Nth occurrence of string starting with the line above the top
of the buffer.
n Next searches for Nth occurrence of the previously entered string
in the direction of the last "/" or "?" subcommand. Typical
usage would be to search for the first occurrence with the "/"
subcommand, then use "n" to find more matches.
N Next searches for next Nth occurrence of the previously entered
search string in the opposite direction to the original "/" or
"?" subcommand.
UpCursor, - Backup N lines and redisplay.
DownCursor, +, Ctrl-J(LF) Move the display down N lines and redisplay.
End Go to the buffer end (where the most recent data is) and display.
x eXit returns to the previous function, and makes the term
function redisplay the last page of buffer contents.[1] This
restores the screen and keyboard to the same state they were in
before review was entered. The x subcommand allows you to see
where you were if you were in the midst of keyboarding a command
to the remote when you entered review.
EXAMPLE: Suppose you are typing in a line of commands and you
need to "thumb back" through the remote's output for some vital
nugget of information. (After you enter a 20 line email reply
__________
1. When the term function takes control, which is immediately if
review was called from the term function.
(C) 1990 Omen Tech Inc Chapter 23 Review Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 190
message, NOW Compuserve asks you for a certain random 8 digit
account number to mail it to!) No sweat, just hit some PgUp's
until you see the account number on the screen. Now you can't
remember whether or not you typed a space after the last part of
you command to the remote. No problem, just exit review with x
and you'll see just where you were.
NOTE: This subcommand should not be used when scripts are active.
k Kill the capture buffer contents and return to the previous
function.
Ctrl-Z, Ctrl-PgDn Kill the rest of the buffer by setting the character
insertion pointer to just after the end of the current display.
ZCOMM then redisplays the last lines of the buffer and returns to
the previous function.
t Set the cut pointers to the top of displayed text, and sets the
bottom cut pointer to the end of the buffer. The t subcommand is
used with the b subcommand to specify which portion of the
circular buffer should be written to a file with the w
subcommand. (Text between the top and bottom pointers is
highlighted.)
b Set the bottom pointer to the beginning of the first line of
displayed text. If the top pointer had not been previously set,
or if the bottom pointer is before the top pointer, ZCOMM will
ring the bell and ignore the subcommand. Otherwise, the text on
the screen that was highlighted will now be displayed in normal
intensity as what is showing on the screen has just been
deselected. (Text between the top and bottom pointers is
highlighted.)
w, W Write (paste) the text between the top and bottom pointers to a
disk file or DOS device.[2] If the top pointer is not set, a
reminder is printed. ZCOMM prompts for a pathname. A blank file
name implies the modem.[3] If the bottom pointer is not set, the
rest of the buffer will be written. No log entry is made by this
subcommand. The W subcommand automatically appends the paste
data to an existing file. A directory for past files may be
specified with the DIRPX environment variable and/or the dirpx
__________
2. Useful DOS devices are PRN, LPT1, LPT2, and LPT3.
3. Data is sent to the modem at full speed with the current parity.
Normally, line feeds are not sent. With n mode, line feeds are
sent and carriage returns are suppressed. With b mode, data is
sent the way it was received.
(C) 1990 Omen Tech Inc Chapter 23 Review Function
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 191
string parameter.
q, F1, ALT-X Quit, return to previous function.
! Prompts for a DOS command, then attempts to execute it (DOS
Gateway).
@ Prompts for a ZCOMM command, then executes it.
(C) 1990 Omen Tech Inc Chapter 23 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 192
24. NUMERIC PARAMETERS
Numeric parameters are set with the p command in the form px# where x
is the one letter name of the parameter and "#" is the numeric value.
Numbers may have an optional leading "-" (minus) sign. Numbers are
normally decimal, but hex numbers may be input as 0xHH, printing ASCII
character values may be entered as 0cC, and control characters may be
represented as 0^C.
Value Possible entries
65 65 0x41 0cA
3 3 0x3 0^C
Typing "p" without a parameter name displays the current values of the
numeric parameters in decimal.
EXAMPLE: pS5 sets the timeout interval in seconds waiting for XON
characters or positive flow control. to decimal 5 seconds.
EXAMPLE: pv-1 sets the v numeric parameter to -1, suppressing some
routine messages
# The # numeric parameter sets the number of lines used by the built
in display driver. The default value is 24. A value of 25 may be
used for applications which require access to all 25 display lines.
A small value may be used when running ZCOMM under TopView to fit
the information into a small window. The cls or reset command
should be given after setting the parameters to initialize the
screen driver to the new values. If running with a virtual screen
with TopView or DESQview, the # and $ numeric parameters are
limited to 24 by 80 maximum. Full screen applications may give
abnormal displays if these parameters are set too small.
Nonsensical values tend to produce nonsensical displays.
EXAMPLE: cls; p#9; reset clears the screen, sets a 9 line window,
and initializes the screen driver to the new value.
$ Sets the number of CRT columns. A cls or reset command should be
given after changing the $ numeric parameter. The default value
(80) is that returned by the BIOS video interrupt 15h call. This
parameter may be set to support 132 column displays if the 132
column display mode is set before ZCOMM is called.[1] ZCOMM does
__________
1. With most display BIOS ROMs, ZCOMM reads the columns and lines
values from the BIOS when starting up or regaining control after a
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 193
not support displays less than 80 columns wide. The display
hardware must use the same number of columns as the $ parameter if
the resultant presentation is to make any sense.
SEE ALSO: # and V numeric parameters
- If non zero, the DOS Gateway (used with the ! command, etc.) uses
the undocumented DOS 37h function to fetch the current value of
SWITCHAR.
If negative, ZCOMM uses DOS line input (function 0xA) for commands
given from the main prompt. This enables DOS command line editors
such as CED. When these editors are active, they (and not ZCOMM)
interpret control, function and ALT- keys.
* Sets the CRT attribute for highlighted messages.
EXAMPLE: p*12 gives bright red.
Adding 1024 to this parameter forces ANSI SGR 1 to use this color.
? Count of the number of files sent or received with a protocol, and
the number of lines matched by the find command. A failed password
validation sets this negative. The exit status of subprograms is
stored in this parameter. Because of a bug in DOS COMMAND.COM, the
return value is valid only with Unix/Xenix flavors.
SEE ALSO: ? test condition
@ Sets the CRT attribute for the (normally) blinking messages such as
FILES OPEN. The numeric values are explained below, with the n
numeric parameter.
EXAMPLE: p@12 makes ZCOMM's normally blinking messages appear
bright red.
Adding 1024 to this parameter forces ANSI SGR 5 and 6 to use this
color.
A If non 0, selects a prefix character which allows ALT characters to
be generated by keyboards without ALT keys. This parameter is
supported on VAX/XMS and Unix platforms; please refer to the
platform specific addendum file for specifics.
______________________________________________________________________
DOS Gateway.
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 194
B If set non zero (the default), causes a bye command to be issued
each time a telephone number is executed as a command.
SEE ALSO: mcommand string parameter, number dialing commands
C If non zero, only display C ESC sequences per screen in the Review
Function, and count escape sequences when advancing or backing up
in the review buffer. Otherwise, ESC sequences are not counted.
E If non 0, substitute this for characters with bad parity detected
by the term function with e mode (Error Containment(TM)).
EXAMPLE: ena -7e; pE63 Substitute ? for characters received with
odd parity.
F Sets the CRT attribute for dim (faint) messages such as ANSI SGR2.
EXAMPLE: pF8 gives gray.
H In Host Operation, sets the timeout in seconds for entering a
command or string in response to a command or other prompt,
including the accept command. A value of 0 (the default) disables
this timeout.
K If non 0, executes keyboard BIOS calls to recover extended codes
from 101 key keyboards.
N When enabled with display mapkb, this parameter controls the
relationship between ANSI/VT52 Alternate Keypad mode (DECKPAM,
ESC=), ANSI Numeric Keypad mode (DECKPNM, ESC>), and the PC's
keyboard Num-Lock state.
0 causes ZCOMM to set the PC's keyboard Num_Lock state to match
Numeric Keypad mode when DECKPNM or DECKPAM is received.
32 causes ZCOMM to set the PC's keyboard Num_Lock state to the
opposite of Numeric Keypad mode when DECKPNM or DECKPAM is
received.
1 causes ZCOMM to set the PC's keyboard Num_Lock on in response to
either DECKPNM or DECKPAM.
2 causes ZCOMM to set the PC's keyboard Num_Lock off in response
to either DECKPNM or DECKPAM.
SEE ALSO: display, mk and ALT-M commands
O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, YMODEM,
and YMODEM-1k downloads. This parameter should be set as follows:
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 195
CompuServe XMODEM This OverThruster mode is known to be effective
on CompuServe. Negative numbers control the number of bytes
added to the window on XMODEM downloads from the network.
Larger numbers increase throughput, but cause improperly
interfaced MNP modems and network nodes to drop characters
under stress, disrupting the file transfer.
EXAMPLE: pO-512; ro file1.ext
Other XMODEM Positive numbers up to a system dependent value less
than the protocol block size increase throughput. Larger
values induce timeouts and/or retransmitted blocks. The
optimum value must be determined by experiment. If you see
the message: Retry 0: Received dup Sector very often, the
value should be reduced. 60 usually give best results with
MNP modems at 2400 bps. The optimum value varies depending on
the remote computer, modem(s), system traffic, and the network
node.
EXAMPLE: pO60; ro file1.ext
R If non zero, remove incomplete files received with a protocol
except those received with the + option (default 0).
S Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
T If Command Reentry has been enabled with the history command, the T
parameter prevents commands with fewer than T characters from being
stored in the history file. Excluding short and easy to type
commands from the history file makes it easier to find the commands
that are difficult to keyboard.
Setting T to a large number disables the storage of commands and
strings. This may be used to exclude passwords and other sensitive
information from the history file.
SEE ALSO: history command
V VIDEO BIOS display mode to switch the display to 132 columns in
response to a VT-100 DECCOLM mode set command. To support boards
using an extended code in the bl register, calculate N = bl + (256
* al).
A popular value is 35 for the Tseng, ATI, and other extended EGA
boards. The Genoa Super EGA Hi-Res likes 96. The Everex EVGA uses
28684. The default value of 0 inhibits this function.
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 196
W This numeric parameter supports Video7 and similar boards which
require a non 0 value in the AH register on INT 10h bios calls for
setting video modes (e.g., 132 columns). The value of the W
numeric parameter (default 0) is placed in the AH register when
attempting to switch video modes.
X On Unix flavors, preset to +1 if the XTERM environment variable
contains xterm, preset to -1 if the variable contains the string
401 indicating a Tektronix storage tube graphics terminal,
otherwise remains at 0. Positive values allow the term function to
use the X Windows xterm status line. Negative values inhibit
status line updates while Tek graphics are active.
Z Hot zone column used for keyboard entry with the message and
privatecommands. A space character keyboarded within the hot zone
finishes the line.
a The a parameter calibrates certain XMODEM and YMODEM protocol
timeouts. The default value is set during initialization to an
appropriate value for an IBM Personal Computer, PC-jr, DG/One, or
8mHz PC-AT (2000 for 4.77 mHz PC, 4000 for a PS2/30, 6000 for an 8
mHz AT, 12000 for a PS2/80). If ZCOMM is run on a non standard
machine, accelerator, or under a time slicing operating environment
such as TopView, these timeouts may be recalibrated with the a
numeric parameter. Larger numbers give longer timeouts. This
parameter should then be set with a pa# command in the telephone
directory setup entry. The value for this parameter will change if
ZCOMM is used with a different computer type or multitasking
operating system.
b Sets the video color for the screen border. The mapping of b
parameter values to color is hardware dependent. New values of the
b parameter take effect with the next screen clear.
c The c parameter sets the callout interval in seconds between scans
for outgoing messages. The default is 300 seconds (five minutes).
EXAMPLE: pc600 sets the interval between callout queue scans to 10
minutes.
SEE ALSO: Callout queue
d A non zero value (the default) causes incoming files received with
ZMODEM and full YMODEM Batch protocol to have their Date set to
that sent in the file header. ZMODEM's file management features
depend on the transmission of each file's modification date. Files
between two copies of ZCOMM will have the same creation date, even
if the two machines are in different time zones. When transferring
files to/from a Unix system, creation dates are interpreted
according to GMT or Universal Coordinated Time. File dating should
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 197
be enabled with a pd1 command in the telephone directory setup
entry.
SEE ALSO: z numeric parameter, ZONE environment variable
NOTE: Backdating file creation times may confuse some backup
programs.
e Indicates the number of errors, failed file transfers and the
number of characters received by the term function with parity
error, framing error or overrun.
EXAMPLE: if e>30 goto badline
If the term function increments the error count to 0[2] (from a
negative number), and E mode is set, the term function exits. This
allows the script to regain control in the event of a noisy line.
This condition is indicated by the e test condition being false
(0).
EXAMPLE: pe-20; ... wait; if !e goto badline
This parameter is reset to 0 by the call command.
SEE ALSO: E mode
SEE ALSO: e test condition (if, while commands)
Unless the q file transfer option is used, each file skipped as a
result of ZMODEM selective transfer increments this parameter.
f Fail time. Sets the default timeout in seconds for matching a
pattern. This timeout is reset whenever a character is received
from the remote. Timeout is suspended whenever a XOFF (DC3 or
Control-S) is keyboarded, and resumed when XON (DC1 or Control-Q)
is keyboarded. The f parameter value may be overridden for one
command by the ftime mode.
EXAMPLE: pf15 sets a default 15 second inactivity timeout for
pattern searches.
g Set the "gochar" (decimal). (See the ASCII/Decimal conversion
table in Chapter 37). The g parameter is reset to its default
__________
2. Refer to E mode description for caveats.
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 198
(linefeed, 10) by the call command. (See documentation on the p
mode.)
Some remote systems accept uploads with a ? (decimal 63) prompt for
each line. Optimum operation with such a system might call for
pg63 pp1000 pt4 f -tp file1
The pg63 sets the goahead character to question mark. The pp1000
sets the timeout to a long delay (10 seconds). The pt4 sets the
upload throttle to 40 milliseconds per characters, a speed which
allows the remote to echo somewhat slowly (assuming no tabs).
Finally, the command f -tp file sends file1 with Throttle and wait
for Prompt at end of line.
As a special case, if the "gochar" is set to 17 (called XON, DC1,
or ^Q) before the p mode is set, file transmission is stopped until
an XON is keyboarded or received from the remote.
EXAMPLE: pg17; ena -p
h Iff the h numeric parameter is set non zero, the h (Half Duplex)
mode causes characters transmitted by the term function to be
stored in the circular buffer as if they had been received from the
remote. This allows the review function to display them. Since
the echoed characters appear to have come from the remote, scripts
may be affected, especially pattern searches.
EXAMPLE: ph1; ena -h
i Set the interval between retries to n seconds.
EXAMPLE: pi4; call -200 busysys attack dials up to 201 times at 4
second intervals.
SEE ALSO: call -n command
j Sets the maximum connect time in seconds allowed restricted callers
in host operation. The default value of 0 does not restrict
connect time.
EXAMPLE: pj300 disconnects restricted callers at the first command
prompt after 5 minutes' connect time.
k When receiving data from the remote at high speeds (9600 or
faster), the display may fall behind data from the remote. Under
these conditions, keyboarding an interrupt character (often Ctrl-C,
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 199
or Break) will immediately stop the output from the remote, but the
display will continue to scroll for some time while the data in the
circular buffer is displayed. If this is objectionable, the k
parameter may be set to the remote's particular interrupt character
(in decimal). This parameter also affects the link command. When
this character is keyboarded, undisplayed data pending in the
circular buffer is skipped over. (This data is still available to
the review command. The call command resets this parameter to -1,
disabling its function.
EXAMPLE: Many DEC systems use ETX (Ctrl-C) to interrupt programs.
Many Unix users also use ETX for interrupting programs. The
command pk3 causes ZCOMM to skip buffered output from the remote.
Unix users using the default interrupt character of RUBOUT may give
the command pk127
l Selects LPTn for term function output when the l mode is set. In
addition, adding 8 to the number allows terminal emulation escape
codes to select "printer controller mode" iff the printer is ready
at the time. Adding 16 to the number allows "printer controller
mode" to be selected even if the printer is not ready at the time.
Default is 1 (LPT1).
EXAMPLE: pl2 selects LPT2.
EXAMPLE: pl9 selects LPT1 and allows the remote application to
enable "printer controller mode".
m Causes file transmission with the f file command to pause when a
character matching the decimal value is read from the file. That
character is NOT transmitted. When the file uploading is paused, a
keyboarded Ctrl-Q will resume transmission. The call command
resets the m parameter to -1 (which matches nothing).
EXAMPLE: pm12 Causes file uploading to pause on FormFeed (FF).
n Set the normal display attribute. The default of 7 gives a normal
white on black display. The numbers associated with the s, r, and
n are stored in the attribute byte of each character position
written in the corresponding mode.
The bit configuration (color display) is: Blink R G B Intensity R
G B with the leftmost the most significant.
Users with color monitors often use 2 (green) to avoid color
fringes caused by misconverged color monitors.
NOTE: the actual writing color attribute is not changed until the
next time the display is reset. Some attributes generate
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 200
unreadable displays. Other attributes generate text that can only
be seen on some monitors.
EXAMPLE: pn3 sets cyan; pn2 sets green.
o Iff non zero, allows overlap of file writing and incoming data from
the remote. This increases throughput when receiving files with B,
Extended Quick B, XMODEM, and YMODEM Batch protocols. ZCOMM sets
this to 1 on startup unless a PC-jr is detected.
p Pause sets the echo wait period (in hundredths of seconds) used
with the pattern command and the w and p modes. Larger numbers
give longer pauses. The default works well with most micro based
bulletin board systems. The p parameter is reset to its default of
70 (700 milliseconds approximately) by the call command.
SEE ALSO: p mode
q Sets the "gopause". When sending a file with a wait for "gochar" (
p mode), ZCOMM waits Gopause hundredths of seconds AFTER it
receives the "gochar". The q parameter also controls the time
delay after a normal pattern match or putw command.
The q parameter is reset to its default of 70 (700 milliseconds
approximately) by the call command. The default value allows time
for immediate echoes to be displayed and for the Hayes
SmartModem(TM) to respond to most commands.
SEE ALSO: p mode
r Set the attribute for "reverse video".
EXAMPLE: pr97 sets "reverse video" to blue on yellow.
Adding 1024 to this parameter forces ANSI SGR 7 to use this color.
SEE ALSO: n numeric parameter
s Set the attribute of the status line display (default 7, for
white). A value of 8 (grey) may be chosen to prevent the status
line display from distracting from the information being printed.
The low intensity grey also minimizes phosphor burn. Some other
possibilities are 2 for green, and 1 for blue (or underlined on the
monochrome board).
SEE ALSO: n numeric parameter
t Sets the throttle speed (delay between characters in hundredths of
seconds) used by the term function when uploading files with an f
-t file command. Throttle controls the term function sending speed
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 201
only when t mode is enabled.
The default value of 4 corresponds to about 20 characters per
second. Larger numbers give slower transmission. The effective
resolution of the t parameter is limited by the timekeeping
resolution of the operating system; on PC-DOS the resolution is
about 18 per second.
A negative value (-1 to -32767) may be used to specify a software
timing loop, with more negative values giving slower transmission.
The speed effect of a negative t value depends on the processor
speed and operating environment.
The t parameter is reset to its default by the call command.
SEE ALSO: t mode
u Sets the video attribute used to represent underline.
EXAMPLE: pu14 sets "underline" to yellow.
Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this
color.
SEE ALSO: n numeric parameter
v Sets the verbose level (default 0). A value less than zero
inhibits some routine messages. A value og 1 or greater enables
logging of files skipped by selective ZMODEM file transfers. A
value greater then zero causes the set command to list all string
parameters, including empty string parameters. The screen erase
after data calls in host operation is disabled. Values greater
than 1 display script commands as they are fetched from the script
file.* Larger values give more detailed tracing information. A
value of 50+ causes data read by the read command to be displayed
and acted upon by the term function (when called) as if it had
arrived from the remote.
NOTE: A v parameter value greater than zero affects scripts that
generate files with the > command.
w Controls the block length used by the CompuServe B Protocol. A
longer length increases throughput, but may overload some networks,
resulting in excessive retransmissions or failed transfers. With
the new Extended Quick-B protocol, the maximum block length is 1024
data bytes. A value of 0 (the default) allows the Compuserve
computer to control the block length, up to 1024 with Extended
Quick-B.
A negative value controls the upload block length but still allows
Compuserve to control the download block length (1024 with Extended
Quick B).
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 202
Uploads to Compuserve using longer block lengths are especially
sensitive to poor flow control, especially when error correcting
modems (MNP, etc.) are used. If B protocol uploads fail or require
excessive retransmissions, correct the flow control arrangements,
disable the modem's error correction, or try a smaller upload block
size.
The data contents of successfully transferred file(s) are not
affected by this parameter.
x Sets the port number linked with the link command.
SEE ALSO: link command, y numeric parameter
y Sets the transmission speed used by the linked port.
SEE ALSO: link command, x numeric parameter
z Set the timeZone in minutes behind GMT (Greenwich Mean Time).
EXAMPLE: pz300 sets timezone 300 minutes behind GMT for EST.
EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST.
SEE ALSO: d numeric parameter, ZONE environment variable
_ The _ numeric parameter controls the action taken by ZCOMM when a
fatal error (one that generates the "ZCOMM: Error..." message).
Any non zero value causes DTR to be dropped (disconnect the modem).
A value greater than 100 causes ZCOMM to exit to the operating
system. The NUKE key does not invoke this processing.
EXAMPLE: p_101
24.1 Kermit Numeric Parameters
The Super-Kermit parameters control Kermit protocol transfers. They
are set with the kermit px# command. Their current values may be
displayed with a kermit p command. These parameters rarely need
changing for most systems. They can be changed in case of difficulty
with Kermit transfers, especially with mainframe programs or obscure
microcomputer Kermit impelementations.
Certain of these parameters require character values expressed in
decimal. The ASCII code chart in Chapter 37 gives the decimal value
of all ASCII characters.
When transferring files with Kermit programs operating on IBM
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 203
mainframes with half duplex front ends, the kermit i parameter should
be set to 1, and the kermit s parameter set to the longest response
time expected, perhaps 45 seconds.
EXAMPLE: kermit pi1; kermit ps45
SEE ALSO: Kermit protocol in Chapter 13
7 If non zero, force seven bit line transmission with eighth bit
quoting Kermit transmission even if ZCOMM is otherwise using eight
bits no parity. This parameter is reset by the call command.
8 If non zero, force 8 bit transparent Kermit transmission even if
ZCOMM is otherwise using seven bit line transmission. Normally, the
Kermit file transfer commands use 7 bit line transmission and
attempt to negotiate 8th bit quoting if one of the 7 bit modes (7e,
7o, 7m, 7s) is used. This parameter is reset by the call command.
a Incoming packet-start character, default 1 (SOH).
A Outgoing packet-start character, default 1 (SOH).
b Block check type requested: 1=1 byte checksum, 2=2 byte checksum,
3=3 byte CRC-16 (default). Selecting a type 1 checksum instead of
type 3 will increase throughput by 2-4 percent[3] at the expense of
weaker error checking. The probability of undetected errors when
using Kermit in checksum mode instead of CRC-16 increases
dramatically with noisy lines and longer packets.
c Control prefix in incoming data, default 35 (pound sign).
C Control prefix in outgoing data, default 35 (pound sign).
d Delay in seconds before initial sending, default 0.
e Incoming end of line character, default 13 (CR).
E Outgoing end of line character, default 13 (CR).
i Use IBM line turnaround, default 0 (don't use IBM line turnaround).
The Kermit x numeric parameter sets the turnaround character. This
may be necessary when communicating with IBM mainframes with half
duplex front ends.
__________
3. for 96 byte packets
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 204
l Maximum outgoing packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. The receiving program
may force shorter packets.
L Maximum incoming packet length, default 1000, 1000 maximum. A value
greater than 94 implies Kermit long packets. This sets a limit; the
sending program may use shorter packets.
p Sets the number of padding characters (default 0) to send before and
after each transmitted packet.
SEE ALSO: kermit y numeric parameter
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
t Override timeout interval in seconds for incoming packets. The
default of 0 allows the other program to specifiy the timeout.
T Timeout interval for outgoing packets, default 4 seconds.
v Eighth bit quoting character, default 38 (ampersand). Sliding
Window size in Kermit packets, 1 minimum, 31 maximum, 15 default.
Setting w to zero disables the sliding window.
x IBM turnaround character, default 17 (XON).
y Pad character to send, default 0 (NUL).
SEE ALSO: kermit p numeric parameter
24.2 X/Y/ZMODEM Numeric Parameters
These parameters control XMODEM, YMODEM, and ZMODEM protocol
transfers. They are set with the z px# command available with ZMODEM
flavors of ZCOMM.
EXAMPLE: z pl16384
Forces ZMODEM packet length of 16384 (default packet length is
infinite).
Their current values can be displayed with a z p command. These
parameters rarely need changing in normal environments.
b If non zero, ZMODEM sends a break when it is sending a file and
receives a retransmission request. This mode of operation may be
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 205
used with high speed modems to clear unwanted characters from the
modem's buffer during error recovery. Usually, the modem must be
given a configuration command to set the proper action to take when
receiving a break signal.
B Sets the duration of the break signal in tenths of a second, default
2 (200 milliseconds).
c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers.
Setting this parameter to 0 accommodates programs with non standard
XMODEM/YMODEM protocols and slightly quickens file transfers. The
default value of 1 provides optimum reliability for XMODEM and
YMODEM transfers with programs that meet the XMODEM/YMODEM spec.
Setting this parameter to -1 disables the quick file compare
provided by the r option.
C Sets the number of times ZMODEM will attempt to send a command (as a
result of a zcommand command) (default 11).
d Sets a delay time in tenths of seconds that the sz command will wait
for a ZMODEM packet in response to the rz<ENTER> string it sends to
the remote before sending a ZMODEM packet. This facilitates
automatic ZMODEM uploads to VMS, which interrupts programs with the
Ctrl-X character. The call command resets this parameter to its
default of 1. Higher values increase the startup time when the
receiving ZMODEM program is started before the sender.
e If non zero, escape all control characters. This allows ZMODEM
transfers to operate over data PBX and other systems that freak out
when they receive control characters.
f Flow control mask, only used with Unix/Xenix systems. Setting this
to 0 (the default) disables hardware (RTS/CTS) flow control for
Xenix/Unix systems with broken hardware flow control. On Xenix/Unix
systems where only CTS flow control works properly, set this to 8192
to allow CTS flow control only. If both RTS and CTS flow control
work properly (rare!) you can use a value of -1 to enable both bits.
F Sets the pause after each data subpacket sent with the sz command
when the F option is used, or when failing flow control is detected.
The default value of 1 causes a one tenth second delay.
SEE ALSO: F option On some Unix operating systems the pause will be
rounded up to the next second or two.
l Normally, the ZMODEM "packet length" ("block length") is the file
length. Setting this parameter non zero forces ZMODEM to close a
frame and wait for an ACK after each # bytes (default 0). This
makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after
each block/packet for an acknowledgement before going on to the next
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 206
block. The packet length may be adjusted to prevent buffer overflow
in data PBX systems. The call command resets this parameter to 0.
L (Default 0) If non zero, overrides the nominal length of data
subpackets within each ZMODEM frame. A smaller value speeds error
recovery on noisy lines, a large value (maximum 1024) reduces the
overhead of CRC characters. The call command resets this parameter
to 0.
Please note that streaming ZMODEM has no direct equivalent to
XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is
set non zero. In the absence of errors, ZMODEM normally sends the
entire file without pause. If somebody claims ZMODEM's 1024 byte
subpacket length is slowing things down by more than one half per
cent, he doesn't understand ZMODEM and should be ignored.
n Sets the number of NULLS (default 0) sent before each ZDATA frame.
Some buffered modems (Fastcomm) have a firmware bug which loses
characters when changing the direction of transmission. This causes
data frames to fail with a CRC or other error. ZMODEM n parameter
values in the range of 100 to 150 have obviated this syndrome.
P When set to 2 (the default), purge the transmit buffer and force a
receiver response when a CR/LF sequence (indicating a PC-Pursuit
DATA LOSS message) is detected. A value of 1 does not purge the
transmit buffer. A value of 0 disables special processing of CR/LF
sequences received by the sending ZMODEM.
w If non 0, restrict the ZMODEM transmit window to the specified
number of bytes. Setting this parameter to N requests
acknowledgements from the receiver every N/4 characters. ZCOMM then
waits for acknowledgements from the receiver whenever it has sent N
more characters than it has received acknowledgements for. This
parameter is useful with networks with defective flow control, and
with networks that store an excessive number of characters in
transit. The call command resets this parameter to 0.
W Adjusts the number of characters the ZMODEM receiver will silently
ignore when searching for the beginning of a new frame. This may be
set larger to accomodate networks with excessive in transit storage,
smaller to speed error recovery from long error bursts on direct
connections. The call command resets this parameter to the default
(1400).
Z Number of minutes (default 0) to adjust the file modification date
when using the Telink or Clink/SEAlink file transfer protocol to
transfer a file between different time zones.
The timeout parameters below may be set lower for faster X/YMODEM
error recovery when transferring files between two micros, higher to
accomodate extremely sluggish systems. Only in pathological cases is
(C) 1990 Omen Tech Inc Chapter 24 Numeric Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 207
it necessary to modify these parameters. The call command resets
these parameter to their defaults.
p Timeout in tenths of seconds for gaps within a packet (default 100).
r If non zero, remove incomplete files received with a protocol except
those received with the + option (default 0).
R When non 0, limits the number of bytes of file comparision used with
the sz and rz -rr option. This parameter may be set to a value
between 2048 and 32000 (1 billion on 32 bit systems). This
parameter is given to the receiving program.
EXAMPLE: z pR30000
SEE ALSO: -rr option
s Timeout interval in seconds waiting for XON characters or positive
flow control (default 15). If an XON is not received within this
time, transmission resumes anyway. A value of 0 disables this
timeout.
t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
waiting for a packet or command acknowledgement (default 100).
T Transmitter timeout in tenths of seconds waiting for a packet
(default 600).
(C) 1990 Omen Tech Inc Chapter 24 String Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 208
25. STRING PARAMETERS
Case is significant in parameter names.
ZCOMM provides two types of string parameters, permament and
temporary. Permanent string parameters are always defined, and most
perform specific defined functions. The permanent string parameters
are described below. The names of the permament string parameters may
be displayed with the command sequence pv1; set given at the command
prompt. Without the pv1 only non empty string parameters are
displayed.
Temporary string parameters* are created by the set, sets, accept, and
grab commands when they do not reference a permament string parameter.
Temporary string parameter names begin with any letter except y and
may have up to 16 letters or digits.
The contents of temporary string parameters may be accessed and
modified when ZCOMM is Restricted. New temporary string parameter
names may not be created when ZCOMM is Restricted.
The set command without arguments displays the current values and
maximum string length for each of the non-empty string parameters. To
set a parameter empty, enter "" as the parameter string (e.g., set
txlog ""). Certain string parameters may be entered with ZCOMM's
character escapes.
When a string parameter is executed, it may be either sent to the
remote as a string or executed as a command if its first character is
@.
EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote.
EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the
screen.
In strings sent to the remote, a \336 (octal 336) character causes a
pause in transmission[1] (controlled by the p numeric parameter),
which may be used to send multiple commands with one string.
An optional underscore prepended to the name of a permament string
parameter causes that string parameter to be cleared by the next call
command.
__________
1. Not including the mput command
(C) 1990 Omen Tech Inc Chapter 25 String Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 209
The following string parameters may not be accessed or modified by the
set command or in string expansions when ZCOMM is Restricted:
backtab bbs break bs esc etx exrc f1...f12 fs1...fs12 fc1...fc12
fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft* fcpgdn*
fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5* fpgdn
fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx
onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub
tab unrestrict xpassword*
The following may not be modified by the set command when ZCOMM is
restricted:
MODEM answerback altprompt baudstr blankfill call1** call2 call3*
callers* calllog* callpath** challenge dircx dirpx dirfx dirrx
dirsx disks dport e emdir entstr eolstr helpfile home hprompt lib
lpnono mcommand mconnect menu messages mprefix mprompt msuffix n1
n2 n3 phones picture plog private rcmdlog* rdisks remote rname*
rxlog* telno tmp tname* twxfile txlog* welcome xhelpfile
The following parameters can never be modified by the set command: ano
args c d drive e h nodename oname1...oname5 parity pwd s speed t w
y y0...y127 yb yf
String Parameters for Remote Operation:
answerback baudstr bbs call1** call2 call3* callers callpath**
challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home
hprompt intolink* linkpass* menu messages oncloserx onclosetx
outahost outalink* password private pwd rcmdlog* rdisks rmtcmd*
rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile
String Parameters for Protocol File Transfer:
adlopts aulopts dirrx dirsx oncloserx onclosetx
String Parameters for Non Protocol File Transfer:
blankfill dircx dirfx eolstr tmodes
String Parameters for Interactive Operation:
Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono
mprompt parity rub tab tmodes xpassword*
String Parameters for Scripts:
ano args c d e h ifs item lib oncloserx onclosetx onexit nodename
oname1...oname5 remote rxcnt s s0...s9 t tmodes tmp y y0...y127 yb
yf
String Parameters for Making Calls:
MODEM l m mcommand mconnect mprefix msuffix telno
String Parameters for Log Keeping:
callers* calllog* plog rcmdlog* rxlog* txlog*
Other String Parameters:
helpfile home kermreset menu onexit picture phones quitcmd
MODEM (Note this variable name is UPPER CASE.) When the advanced
dialer described in Chapter 9 is used, MODEM contains the file
name of the modem specific dial routine to use.
(C) 1990 Omen Tech Inc Chapter 25 String Parameters
Version 17.78 TurboDial 2.35 Universal Line Printer Edition
ZCOMM User Manual 210
adlopts Contains option(s) to be used for ZMODEM AutoDownloads.
EXAMPLE: set adlopts "r" Use the r option (crash recovery) for
files automatically downloaded with ZMODEM.
alds An optional string to be used for controlling Alternate Long
Distance Services. On Unix systems, allows assignments to the ALT
keys a to z.
ano After invoking one of the date related string parameters, the ano
string contains the last two digits of the year.
answerback When term is in q (TWX) mode, an answerback is sent in
response to an incoming ENQ. The format of Answerback is
determined by the Western Union Telegraph Company. It typically
consists of
\r\nNAME CITY\r\n\021
as entered by the set command using character escapes. (In the
TWX protocol, the 021 (XON) at the end of the answerback turns on
the tape reader.) The answerback string must begin with CR,LF.
args contains the complete calling sequence to the current script
level.
EXAMPLE: call ge,upl accesses the genie telephone directory entry
and stores ge.upl in args.
altprompt Overrides the default auxilliary command prompt generated by
the ALT-2 key.
EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m "
Display the current disk drive (%c) and directory (%pwd)
highlighted (\E[1m) and in lower case (\L).
N.B.: If you access Unix systems with ZCOMM, choose an altprompt
string that is distinct from your Unix prompt.
SEE ALSO: hprompt, mprompt, nodename, drive, pwd string parameters
aulopts Contains option(s) to be used with the sz command. aulopts is
processed by the sz command before any options given to the
command itself.
backtab Assigns a string or command to the BACKTAB (Shift TAB) key.
baudstr When ZCOMM gets a connect in host operation, ZCOMM executes
baudstr.
EXAMPLE: set baudstr "@gosub .%lib/baud.t"
(C) 1990 Omen Tech Inc Chapter 25 String Parameters